Documentation Center

DocumentObj 2.5 RetrieveRevisionInfoByIshLngRefs [internal]

Retrieves metadata and revision information from Content Manager when the identifiers for the language levels (language reference card ids) are known.


Parameters

NameTypeDirectionDescription
psAuthContextStringInOutDeprecated proprietary authentication context only used by .ASMX web services based on internal username/password authentication. Claims based security standards drive all the WCF .SVC web services making this parameter redundant.
palLngRefsLongArrayInLong list with the unique identifiers of the language objects
psXMLRequestedMetadataStringInRequested Metadata XML structure indicating which metadata has to be retrieved for a given object.
psOutXMLObjListStringOutRevision Information ObjectList XML structure containing the requested metadata and the revision information.

Requirements are:
  • The user must have read access for the folder holding the object.

Language reference card ids, also known as lngrefs, point exactly to the latest revision of a certain logical/version/language combination. So using a language reference card id directly bypasses the calculation algorithm to derive it from logical/version/language.

Example

<ishobjects>
  <ishobject ishref="GUID-6B658E0D-415E-4DF7-8697-6B3C899A807D" ishtype="ISHModule" ishlogicalref="29037" ishversionref="31071" ishlngref="31072">
    <ishfields>
      <ishfield name="FTITLE" level="logical" xml:space="preserve">installing the sim card and battery</ishfield>
      <ishfield name="FDESCRIPTION" level="logical" xml:space="preserve" />
      <ishfield name="FMODULETYPE" level="logical" xml:space="preserve">Task</ishfield>
      <ishfield name="VERSION" level="version" xml:space="preserve">2</ishfield>
      <ishfield name="DOC-LANGUAGE" level="lng" xml:space="preserve">en</ishfield>
      <ishfield name="FSTATUS" level="lng" xml:space="preserve">Released</ishfield>
      <ishfield name="FSTATUS" level="lng" xml:space="preserve" ishvaluetype="element">VSTATUSRELEASED</ishfield>
      <ishfield name="CREATED-ON" level="lng" xml:space="preserve">03/04/2008 17:30:04</ishfield>
      <ishfield name="MODIFIED-ON" level="lng" xml:space="preserve">04/07/2012 13:43:20</ishfield>
      <ishfield name="FAUTHOR" level="lng" xml:space="preserve">Admin</ishfield>
    </ishfields>
    <ishchanges>
      <ishchange revisionid="GUID-8DE6872E-F4DF-4680-BD8C-89E887B0450D" sequence="1" on="03/04/2008 17:30:03" by="Admin">
        <ishfieldchange name="FSTATUS" level="lng">Draft</ishfieldchange>
      </ishchange>
      <ishchange revisionid="GUID-6EAB70F2-CA46-4BC0-B43F-0008F91F860B" sequence="2" on="12/08/2009 11:25:37" by="Admin" />
      <ishchange revisionid="GUID-6EAB70F2-CA46-4BC0-B43F-0008F91F860B" sequence="3" on="14/09/2010 08:32:53" by="Admin">
        <ishfieldchange name="FSTATUS" level="lng">To be reviewed</ishfieldchange>
      </ishchange>
      <ishchange revisionid="GUID-6EAB70F2-CA46-4BC0-B43F-0008F91F860B" sequence="4" on="25/01/2011 17:06:55" by="Admin">
        <ishfieldchange name="FSTATUS" level="lng">Draft</ishfieldchange>
      </ishchange>
      <ishchange revisionid="GUID-6EAB70F2-CA46-4BC0-B43F-0008F91F860B" sequence="5" on="04/07/2012 13:43:02" by="GLOBAL\vlezhnenko">
        <ishfieldchange name="FSTATUS" level="lng">Released</ishfieldchange>
      </ishchange>
    </ishchanges>
  </ishobject>
  ...
</ishobjects>